home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wclist20.zip / WCLIST.DOC next >
Text File  |  1992-02-06  |  11KB  |  313 lines
  1.  
  2.      16/12/91                    WCLIST v2.00                        Page 1
  3.     -----------------------------------------------------------------------
  4.  
  5.       
  6.      Description:
  7.                  
  8.           WCLIST is compatible with Wilcat! 3.0 +. WCLIST produces an
  9.           ASCII file listing , dependent on the switches used, from
  10.           your files database file and the filearea database. By Default
  11.           it will use allfiles.dat and filearea.dat.
  12.  
  13.  
  14.      Command Line: 
  15.  
  16.      WCLIST [f1 [[f2] [f3]]] [/Switchs<instruction>]
  17.  
  18.      For Example:
  19.  
  20.      WCLIST c:\wc30\data\allfiles.dat c:\wc30\filearea.dat c:\dbwcact.lst
  21.      /A30 /F2 /L2 /V /Hc:\head.txt > wclist.log
  22.  
  23.      This example produces a list of files that have been uploaded in the
  24.      last 30 days, using US date formating, 2 line descriptions, where
  25.      required, displaying to the screen while writing the listing to disk
  26.      and including head.txt to the begining of the file listing. All error
  27.      output has been piped to wclist.log.  By using the different 
  28.      combinations of switches you are able to produce many different file 
  29.      listings.
  30.  
  31.      Operation:
  32.  
  33.  
  34.        f1               This parameter contains the path and name of the
  35.                         files data file. The default file file name is
  36.                         ALLFILES.DAT.
  37.  
  38.                         For Example:  [d:\path\[f1]]
  39.  
  40.        f2               This Parmeter Contains the Path and name of your
  41.                         file area information data file. The default is
  42.                         FILEAREA.DAT.  If no path is supplied then the
  43.                         current directory will be the default path.
  44.  
  45.                         For Example:  [d:\path\[f2]]
  46.  
  47.        f3               This parameter contains the path and name of the
  48.                         file listing requested. The default name is FILES.BBS
  49.                         which will be placed in the directory where WClist
  50.                         is run from.
  51.  
  52.                         For Example:  [d:\path\[f3]]
  53.  
  54.  
  55.  
  56.  
  57.   --------------------------------------------------------------------------
  58.   Copyright 1991-92 by John Oxenham & Chris Groothoff -- ALL RIGHTS RESERVED 
  59.  
  60.      16/12/91                    WCLIST v2.00                        Page 2
  61.     -----------------------------------------------------------------------
  62.       
  63.      Switches
  64.  
  65.      All swithes are optional, and must be preceded by '/'.
  66.  
  67.  
  68.         /An              Lists files by age, where n = 0 to +-999 days. 
  69.                          The default setting is /A0. If a positive number 
  70.                          is supplied the listing will show files that are
  71.                          n days old. If a negative number is supplied the 
  72.                          listing will produce a list showing files that
  73.                          have been on the system for more than or equal
  74.                          to n days.
  75.  
  76.  
  77.        /Fn               Displays the date in n format.  The date format
  78.                          choices are: n = 1 dd-mm-yy, n = 2 mm-dd-yy
  79.                          The Default = /D1).
  80.  
  81.        /Dn               Displays files greater than or equal, or less
  82.                          than or equal to the Times Downloaded, where n
  83.                          is a value from 0 to+-999. The Default = /D1:0.
  84.                          If /d-3 is entered then all files downloaded less
  85.                          than or equal to 3 times will be displayed.
  86.  
  87.        /Pw               Displays files with a Password of w. Where
  88.                          w = password. The Default = None.
  89.  
  90.        /S                Lists passworded files with their passwords.
  91.  
  92.        /Ln               Format for displaying the file description
  93.                          in the listing. The format for n = 1 to 2,
  94.                          and refers to either a 1 or 2 line Description.
  95.                          The Default = /L1.
  96.  
  97.        /V                Verbose, displays the listing to the screen as
  98.                          well as to disk. The Default = None
  99.  
  100.        /Hf               Allows you to include a header file to the top
  101.                          of your file listing, where f is the path and
  102.                          name of the file to be included.
  103.  
  104.                          For Example: [d:\path\[f]]
  105.  
  106.                          The Default = None.
  107.  
  108.  
  109.        /On               Sorts the listing according to:
  110.                          1 = Order by file area and filename; and
  111.                          2 = Order by file area and Date.
  112.                          The Default = /O1).
  113.  
  114.  
  115.        /?                Displays the help screen.
  116.  
  117.   --------------------------------------------------------------------------
  118.   Copyright 1991-92 by John Oxenham & Chris Groothoff -- ALL RIGHTS RESERVED 
  119.  
  120.  
  121.      16/12/91                    WCLIST v2.00                        Page 3
  122.     -----------------------------------------------------------------------
  123.  
  124.      Copyright:
  125.  
  126.           This program is distributed as SHAREWARE.  Under this concept you
  127.           may use the SHAREWARE (UnRegistered) version for a reasonable
  128.           period of time, which We consider to be 45 days, after which you
  129.           must register your copy or discontinue usage all together.
  130.  
  131.      Warranty:
  132.  
  133.           This program is provided "as is" without any warranty of any
  134.           kind.  The entire risk of using this program is assumed by you.
  135.           We suggest you backup your files before using all programs to
  136.           prevent unrecoverable damage.
  137.  
  138.      Registration:
  139.  
  140.           With registration you will receive access to download or File
  141.           Request any further minor updates from D'Bridge! <=> Wildcat!
  142.           Support - ACT at no extra cost.  The registration and Pricing
  143.           details are contained in the file WCLIST.REG included with
  144.           this program archive.  To register Complete WCLIST.REG and 
  145.           return the completed details with your cheque or money order
  146.           drawn in Australian Dollars.
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.   --------------------------------------------------------------------------
  155.   Copyright 1991-92 by John Oxenham & Chris Groothoff -- ALL RIGHTS RESERVED 
  156.  
  157.      16/12/91                    WCLIST v2.00                        Page 4
  158.     -----------------------------------------------------------------------
  159.  
  160.  
  161.      Additional Features of Registered Version:
  162.  
  163.           o    Removal of all Unregistered messages and Opening Screen.
  164.           
  165.           o    Registration on the Support BBS to either logon as a normal
  166.                user or file request Minor Updates.
  167.  
  168.           o    Notification of changes and updates.
  169.  
  170.           o    Support by either Telephone or Netmail.
  171.  
  172.      
  173.      Distribution: 
  174.  
  175.           You are free, in fact encouraged, to distribute the SHAREWARE
  176.           (UnRegistered) version of this program in the original archive in
  177.           absolute original unmodified form. 
  178.  
  179.      Files Included in Archive: 
  180.  
  181.           WCLIST.EXE   This is the executable file.
  182.  
  183.           WCLIST.DOC   This document file.
  184.  
  185.           WCLIST.REG   Registration and Pricing Details.
  186.  
  187.  
  188.      Acknowledgements: 
  189.  
  190.           o    Wildcat! (tm)  (c) Mustang Software, Bakersfield, CA.
  191.  
  192.           o    This programs were written using Turbo Pascal 6.0 from
  193.                Borland International, Scotts Valley, CA. 
  194.           
  195.           o    B-Tree Filer - TurboPower Software.
  196.  
  197.  
  198.  
  199.      Technical Support (Available to Registered Users Only): 
  200.  
  201.           The author's are available to provide technical support if you 
  202.           have problems with WCLIST.  You may contact John Oxenham or 
  203.           Chris Groothoff 24 hours a day at D'Bridge <=> Wildcat Support/ACT
  204.           BBS, +61-6-259-1951. Or you can send Netmail Messages to us at
  205.           Fidonet 3:620/255 or Dbnet 201:300/307.
  206.  
  207.  
  208.  
  209.  
  210.  
  211.   --------------------------------------------------------------------------
  212.   Copyright 1991-92 by John Oxenham & Chris Groothoff -- ALL RIGHTS RESERVED 
  213.  
  214.      16/12/91                    WCLIST v2.00                        Page 5
  215.     -----------------------------------------------------------------------
  216.  
  217.  
  218.  
  219.                                    APPENDIX A
  220.                                 Error Messages
  221.  
  222.     Error No.         Description
  223.  
  224.      2               File not found -  Cannot find database file
  225.                      or invalid filname.
  226.  
  227.      3               Path not Found - Invalid path specified or drive
  228.                      not ready.
  229.  
  230.      4               To many files open. - To many files open
  231.                                          - Check Files setting in config.sys.
  232.  
  233.      5               File access denied - Directory is full or file
  234.                                           is read only.
  235.  
  236.      100             Disk read error.
  237.  
  238.      101             Disk write error or Disk full.
  239.  
  240.      150             Drive write protected.
  241.  
  242.      152             Drive not ready.
  243.  
  244.      176             Disk Drive Full.
  245.  
  246.  
  247.     Issam Error No   Description
  248.  
  249.      10010           Program Aborted - Index file defective.
  250.  
  251.      9903            Program Aborted - Data file does not exist.
  252.  
  253.  
  254.     The error numbers supplied here are the most common expected errors. 
  255.     There are to many error numbers to be listed in this appendix.
  256.  
  257.     Reporting Errors:
  258.  
  259.     You can report errors to us by Netmail to Fidonet 3:620/255,by mail or
  260.     by logging onto D'Bridge   <=> Wildcat Support - ACT BBS and Leaving
  261.     us a message.
  262.  
  263.     You will need to supply details of your config.sys file, your hardware
  264.     setup together with the error number and a short description of the
  265.     events leading up to the error.
  266.  
  267.  
  268.  
  269.  
  270.   --------------------------------------------------------------------------
  271.   Copyright 1991-92 by John Oxenham & Chris Groothoff -- ALL RIGHTS RESERVED 
  272.  
  273.      16/12/91                    WCLIST v2.00                        Page 6
  274.     -----------------------------------------------------------------------
  275.  
  276.  
  277.                                    APPENDIX B
  278.                                 REVISION HISTORY
  279.       
  280.  
  281.       6/10/91        WCLIST 1.0 Released.
  282.  
  283.  
  284.      16/12/91        WCLIST 2.0 Released.
  285.                      Deleted need to run WCREPAIR before generating
  286.                      a file listing.
  287.                      Added Switches:
  288.  
  289.                      /An Age of files uploaded.
  290.  
  291.                      /fn Display date in US or British Format.
  292.  
  293.                      /Dn Lists files greater or less than n.
  294.  
  295.                      /Pw List files with password.
  296.  
  297.                      /S  List all Passworded files with Passwords.
  298.  
  299.                      /Ln File listing with Description of 1 or 2 lines.
  300.  
  301.                      /V  List to screen and disk file.
  302.  
  303.                      /Hf Include a header file.
  304.  
  305.                      /On Order list by file area and filename or
  306.                          by file area and date.
  307.  
  308.                     No longer limited by Memory considerations.
  309.  
  310.  
  311.   --------------------------------------------------------------------------
  312.   Copyright 1991-92 by John Oxenham & Chris Groothoff -- ALL RIGHTS RESERVED 
  313.